home *** CD-ROM | disk | FTP | other *** search
/ Saar AMOK 2 / Saar AMOK II - Oktober 1994 (1994)(Kreativ Marketing)(DE)[!][I-7598].iso / tools / aminet-infodisk / tools / abackup / abackupenglish.doc < prev    next >
Text File  |  1994-02-22  |  59KB  |  1,181 lines
  1.  
  2.  
  3.                 ABackup - User's Manual
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.  
  11.       This manual describes release 4.06  of  the  utility    ABackup.  This
  12.   program is (c)1992-1994 by Denis GOUNELLE, any commercial usage  or  selling
  13.   without author's written authorization is strictly forbidden. You  can  copy
  14.   and spread this program under the following conditions:
  15.  
  16.     - all the files are provided
  17.     - the files are not modified in any way
  18.     - you don't charge more than $6 for copy fee
  19.  
  20.       In spite of several tests, no warranty is made  that    there  are  no
  21.   errors in ABackup. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no event will I
  22.   be liable for any damage, direct  or    indirect,  resulting  of  the  use  of
  23.   ABackup.
  24.  
  25. Introduction
  26.  
  27.       ABackup is a backup program written for the Amiga. It  may  be  used
  28.   both to make a backup of  your  hard    disk  or  to  archive  files,  handles
  29.   non-AmigaDOS partitions, has a full Intuition interface,  and  can  use  XPK
  30.   library. Under 2.0 system release, ABackup is able to recognize links and to
  31.   manage high density disks.
  32.       As this program contains some unusal features, it is recommended  to
  33.   read this documentation carefuly.
  34.  
  35.       Criticisms and suggestions will always be welcomed. Write to:
  36.  
  37.                    M. GOUNELLE Denis
  38.                   27, rue Jules GUESDE
  39.                 45400 FLEURY-LES-AUBRAIS
  40.                      FRANCE
  41.  
  42.       You can also send a message to  the  following  Internet  address  :
  43.   "gounelle@alphanet.ch". Note that this mailbox is not mine, so  please  send
  44.   only short messages. As I don't have direct access to  the  messages,  don't
  45.   expect an answer before a dozen of days.
  46.  
  47. Contribution
  48.  
  49.       This program is SHAREWARE. If you find it useful, I  invite  you  to
  50.   send at least $10 at    the  address  listed  above,  in  order  to  become  a
  51.   registered user. Please use only:
  52.  
  53.       - checks from a French bank
  54.       - cash (French Francs prefered, otherwise any currency of the E.E.C.  is
  55.     accepted, as well as US dollars and Swiss  Francs  ;  in  either  case
  56.     please add a little more for change fee)
  57.       - checks from an European bank (if you use an EuroCheck, please  add  $8
  58.     because my bank taxes it)
  59.  
  60.   If you send me a check, it must be in French Francs and the beneficiary must
  61.   be "M. GOUNELLE Denis". In either case, be sure to give  your  full  address
  62.   and to make it readable.
  63.       As a registered user, you will receive the next version  of  ABackup
  64.   as soon as it will be available. You should be aware that a $10 contribution
  65.   fee only gives right to one update: if you want to receive the next  updates
  66.   regularly, a $20 contribution is required.
  67.  
  68. Thanks
  69.  
  70.   I would like to thanks the following:
  71.  
  72.   Reza Elghazi,
  73.   Jean-Yves Proux,
  74.   Jean-Philippe Rapp,
  75.   Michel Schinz,
  76.   and everyone who send me a suggestion or reported a bug,
  77.  
  78.   Reza Elghazi,
  79.   Stefan Salewski,
  80.   for their help concerning the crash under system 3.0,
  81.  
  82.   Horst Schumann,
  83.   Fred Hamilton,
  84.   beta-tester for non-AmigaDOS partitions support,
  85.  
  86.   Kai Rode,
  87.   Stefan Salewski,
  88.   for the german translation of the program and the documentation,
  89.  
  90.   Bryan Ford,
  91.   Urban Dominik Mueller,
  92.   et the others XPK library authors,
  93.  
  94.   and everyone who send me a contribution.
  95.  
  96.   Also, a lot of thanks to Yves Perronoud, Jean-Philippe Rapp, Marc  Schaefer,
  97.   and Michel  Schinz  for  constant,  enthusiast  and  (almost)  unconditional
  98.   support.
  99.  
  100. Getting_started
  101.  
  102.       ABackup can be run from CLI and  from  Workbench.  Usually,  ABackup
  103.   tries to create a child task that will  perform  all    write  operations,  in
  104.   order to make backup faster.    If  the  task  creation  fails,  ABackup  will
  105.   perform write operations by itself, just like  the  first  versions  of  the
  106.   program.
  107.  
  108.       From the CLI, you can invoke ABackup as follows:
  109.  
  110.       ABackup  [FROM  directory]  [BUFSIZE  size]   [NOCOMP   ext,ext,...]
  111.       [NOTASK] [TMPDIR dir] [SIZE {BYTE|KBYTE|MBYTE|AUTO}] [USEASL]  [FONT
  112.       nameY]
  113.  
  114.   The FROM option allows to specify a directory name for backup.  By  default,
  115.   this one will be the current directory.
  116.   The BUFSIZE option allows to change the size of the  write  buffer  for  the
  117.   child task (for example "BUFSIZE 64" asks for a 64 Kb buffer).  By  default,
  118.   the buffer is 12 Kb large, which gives the same speed  as  version  2.43  of
  119.   ABackup. This buffer is allocated in CHIP memory,  but  is  only  used  when
  120.   backing up to floppy disks. A larger buffer may increase backup speed up  to
  121.   20%, but take care that a very large buffer may not give the best gain:  the
  122.   optimal buffer size depends of the speed of your Amiga, of  the  compression
  123.   method used, and of the average size of your files. On my A3000,  a  128  Kb
  124.   buffer is quite perfect.
  125.   The NOCOMP option allows to  specify    extensions  of    file  names  to  don't
  126.   compress. You can specify up to 10 extensions, separated by a  comma    (e.g.:
  127.   "NOCOMP .info,.run"). This specification overwrites the  one  saved  in  the
  128.   configuration file (see backup options).
  129.   If the creation of the child task is a problem (no memory  etc...)  you  can
  130.   prevent ABackup to create it with the NOTASK argument.
  131.   The TMPDIR argument allows you to change the    temporary  directory  used  by
  132.   ABackup. By default, it uses the "T:" directory, but this may lead to memory
  133.   problems, especially if this directory is assigned to "RAM:T".
  134.   The SIZE argument allows you to change the default unit of the  "Size"  menu
  135.   (see below).
  136.   The USEASL argument allows you to use the file  requester  of  "asl.library"
  137.   instead of the built-in requester.  This  option  will  be  ignored  if  the
  138.   library can't be opened, or if the requester can't be allocated.
  139.   The FONT argument allows you to specify the font to use. By default, ABackup
  140.   uses    the  default  "text"  font.  The  font  will  be  refused  if  it   is
  141.   proportionnal, by there are no size checking. The syntax for    font  name  is
  142.   "nameY", e.g. "topaz8".
  143.  
  144.       From the Workbench, you can change the size of the write  buffer  by
  145.   adding a line of the form "BUFSIZE=<size in Kb>" in the "TOOL  TYPES"  field
  146.   of ABackup icon. You can also specify extensions  of    file  names  to  don't
  147.   compress by adding a line of the form "NOCOMP=ext,ext,...", prevent  ABackup
  148.   to create a child task by adding a line "NOTASK", change  the  unit  of  the
  149.   "Size" menu by adding a line  of  the  form  "SIZE=unit",  ask  to  use  the
  150.   "asl.library" file requester by adding a  line  of  the  form  "USEASL",  or
  151.   select a font by adding a line of the form "FONT=nameY".
  152.       You can set ABackup as "DEFAULT TOOL" of an archive file,  and  call
  153.   it with an icon as an argument. If  this  icon  is  a  directory  icon,  the
  154.   contents of this  directory  will  immediatly  be  loaded,  and  the    backup
  155.   selection screen will be displayed. If this is a  file  icon,  ABackup  will
  156.   assume it's an archive file, load it's catalogue  and  display  the  restore
  157.   selection screen.
  158.  
  159.       When the program starts, a screen is displayed with several  gadgets
  160.   on it: click on the gadget that  matches  the  wanted  action.  The  startup
  161.   screen has also a menu with the "Config...", "About..." and "Quit"  options.
  162.   The first one allows to modify ABackup  configuration  (see  "Configuration"
  163.   section), the second one displays informations about the  program,  and  the
  164.   last one allows to quit ABackup.
  165.  
  166. Configuration
  167.  
  168.       A window appears in the middle of the screen,  with  eight  gadgets.
  169.   The first three gadgets show the names of the viewer programs  corresponding
  170.   to the type of a file (ASCII file, IFF picture or other, see  the  "Viewing"
  171.   section), the two next the names of the  external  compression/decompression
  172.   programs (see the "Compression" section), and  the  last  the  name  of  the
  173.   temporary directory (see the "Getting_started" section).
  174.       At the bottom of the window, three gadgets enable  to  validate  the
  175.   changes, to validate and save the changes, or to  cancel  the  changes.  The
  176.   configuration is saved to the "S:ABackup.config" file, which is loaded  each
  177.   time the program start.
  178.       When you save the configuration, the current color palette  is  also
  179.   saved. This allow to change ABackup default colors,  for  example  with  the
  180.   "Colors" program provided on the system disks.
  181.  
  182. Requesters
  183.  
  184.       When using ABackup, often you'll see requesters with one message and
  185.   one or two gadgets ("Ok", "Continue/Abort", "Yes/No").
  186.  
  187.       In any case, you can reply to a request by clicking on one of  these
  188.   gadgets, or by pressing the key corresponding to the first letter of a reply
  189.   (for example, the "c" or  "C"  key  for  "Continue").  You  can  also  press
  190.   <RETURN> for a positive reply ("Ok",  "Continue",  "Yes")  or  <ESC>  for  a
  191.   negative reply ("Abort", "No").
  192.  
  193.       Finally, when a requester message asks for inserting a disk  in  one
  194.   drive, inserting a disk in this drive will be  detected  and    this  will  be
  195.   equivalent to clicking on the "Continue" gadget.
  196.  
  197. Backup_an_AmigaDOS_partition
  198.  
  199.       A requester is displayed that allows    to  choose  the  directory  to
  200.   backup. By clicking on the "Cancel" gadget, ABackup will return to the  main
  201.   screen. By clicking on the "OK" gadget,  ABackup  will  load  the  directory
  202.   contents. To stop this loading, click on the "Abort" gadget or press one  of
  203.   the following keys: "a", "A", <ESC>.
  204.       If you don't want ABackup to explore a sub-directory (for example  a
  205.   directory where's a program that you already have on floppy disk, and so you
  206.   don't need to backup), just put the word "SKIPME" as the  comment  for  this
  207.   sub-directory.
  208.  
  209.       ABackup can now save several partitions in the same archive, so  you
  210.   don't have to save them one by one. To select the partitions  to  save,  you
  211.   can use the multi-selection of the file requester: click  on    the  partition
  212.   names (like DH0: and DH1:) holding the SHIFT key down.
  213.       You can also call ABackup with the  FROM  option,  and  specify  the
  214.   partition names separated by a comma (like "FROM DH0:,DH1:"). In this  case,
  215.   if you use the Intuition interface, you won't see the  file  requester  when
  216.   you will click on "Save an AmigaDOS partition".
  217.  
  218.       Once the directory contents loaded, the selection screen will  apear
  219.   (see the "The_selection_screen" section below). Backup options are:
  220.  
  221.   Compress
  222.       Tells what kind of compression will be done:  none  (NO),  with  the
  223.       functions integrated to ABackup (Internal), with an external program
  224.       (External)  or  with  XPK  library.  For  more   informations,   see
  225.       "Compression" section. If you press the SHIFT  key  when  you  click
  226.       upon this gadget, the values will cycle in reverse order.
  227.  
  228.   Verify
  229.       Read and compares every track after writing it. Meaningful only  for
  230.       backup to disks.
  231.  
  232.   Encryption
  233.       Data are encrypted  with    a  password,  which  will  be  asked  when
  234.       starting backup. CAUTION ! IF YOU  LOOSE    THIS  PASSWORD,  YOU  WILL
  235.       NEVER BE ABLE TO RESTORE DATA IN ARCHIVE ! You will be asked to give
  236.       this  password  again  for  every  read  operation  on  the  archive
  237.       (restore, list, catalogue rebuild),  so  that  ABackup  can  decrypt
  238.       data.
  239.  
  240.   Backup links
  241.       Backup selected links. Meaningful only under 2.0 system release.    An
  242.       archive which contains links can of course be  restored  even  under
  243.       1.3 system release (links will simply be not restored).
  244.  
  245.   Set archive bit
  246.       Once backup is over, sets the archive bit (see the AmigaDOS  command
  247.       "Protect") of all files and subdirectories successfully backed up.
  248.  
  249.   Backup report
  250.       The left gadget tells if ABackup has to create a backup report. This
  251.       one can be printed or written to a file. The right gadget  tells    if
  252.       this report will be a long one (detailled)  or  a  short  one  (only
  253.       errors).
  254.  
  255.   Backup to
  256.       Selects an archive. If a given name is  of  the  form  "df?:"  (e.g.
  257.       df0:, df1:, etc....), ABackup will use the specified  disk  unit    by
  258.       writing on disks in a special format. In this case, you need not    to
  259.       format your backup disks. Otherwise, ABackup will create an  archive
  260.       file with the name you specified. Note ABackup has the capability of
  261.       creating this file on any device that accepts  the  AmigaDOS  Seek()
  262.       function.
  263.       You can use several disk drives for backup: specify the names of the
  264.       drives separated by a coma. For example, if you specify  "df0:,df1:"
  265.       ABackup will start with disk in df0:, then continue with the disk in
  266.       df1:, go    back  to  df0:,  etc...  The  program  will  automatically
  267.       (without requester) toggle from one drive to the next, if  the  disk
  268.       in the new drive has been changed.
  269.  
  270.   Don't compress
  271.       Allows to specify extensions of file names to  don't  compress.  You
  272.       can specify up to 10 extensions, separated by a comma.
  273.  
  274.       For starting a backup, you  have  to    select    the  "Start"  item  in
  275.   "Backup" menu or the "START" gadget. If you asked for backup  report  to  be
  276.   written to a file, a requester will be brought up so that you can specify  a
  277.   name for this file. If you click over the "Abort" button in this  requester,
  278.   no report will be generated.
  279.  
  280.       At this time, a new screen is brought up with different infos on the
  281.   backup progression. In the bottom area, the file names pass by, followed  by
  282.   an info on the current operation (compression, writing, etc....). The "Disk"
  283.   gauge displays the filling percentage either of the current disk, or of  the
  284.   volume where is the archive file. If you asked for a disk  backup,  you  can
  285.   remove the last disk from your drive as soon as the "Archive closed" message
  286.   will be displayed.
  287.       If an error occurs (and if this is possible), ABackup will display a
  288.   message to ask if you want to continue in spite of that. Obviously,  ABackup
  289.   will not make a backup for the file that maked problem.
  290.       At the top and on the right of this screen there  are  two  gadgets.
  291.   The "* ABORT *" gadget allows to abort a backup. After it asked to  confirm,
  292.   ABackup returns to the selection screen. The "* PAUSE *"  gadget  allows  to
  293.   pause a backup for a while. Note that it can happens ABackup    doesn't  react
  294.   immediatly when you click over one of these gadgets but, in all cases,  your
  295.   request will be registered before the next write operation in the archive.
  296.  
  297.       Once a backup ended (a message will inform  you  of  that),  ABackup
  298.   returns to its main screen.
  299.  
  300. Backup_a_non_AmigaDOS_partition
  301.  
  302.       This allow for example to backup a MS-DOS partition, or an  AmigaDOS
  303.   partition without worring about it's contents. The selection screen appears,
  304.   and show the list of all partitions of the system. This screen is  described
  305.   at the "The_selection_screen" section.
  306.       You can save only one partition at a time. Backup  options  are  the
  307.   same as for a normal backup, with the difference that you can't use external
  308.   compression.
  309.       The backup operation itself is  quite  the  same  as    for  a    normal
  310.   backup. Please refer to the "Backup_an_AmigaDOS_partition" section for  more
  311.   details, and also to the "Restore" section for some important  informations.
  312.  
  313. Restore
  314.  
  315.       A menu is brought up allowing to specify the archive    that  must  be
  316.   used. If you click on the "Abort" gadget, ABackup will return  to  the  main
  317.   screen. The gadgets corresponding to your drives are    automatically  enabled
  318.   or disabled according to your hardware configuration. If you click on one of
  319.   these enabled gadgets, ABackup will ask you to insert the last disk  in  the
  320.   backup set, in order to load the catalogue.  If  you    click  on  the    "File"
  321.   gadget, a requester will be brought up so  that  you    specify  your  archive
  322.   file. If you click on the "Abort" gadget, ABackup will return  to  the  main
  323.   screen.
  324.  
  325.       If the selected  archive  contains  the  backup  of  a  non-AmigaDOS
  326.   partition, ABackup will ask you if you want to restore it. If you agree, the
  327.   restore operation will start immediatly. This operation is described    below.
  328.  
  329.  
  330.  
  331.                     CAUTION:
  332.  
  333.       Restoring a non-AmigaDOS partition will not be  possible  if
  334.       the caracteristics of the partition has been modified:  this
  335.       means that it's size and location (for example) must be  the
  336.       same as when backing up.  Also,  ABackup  can't  format  the
  337.       destination disk: if you restore  the  partition  on    a  new
  338.       disk, you must format it before. 
  339.  
  340.       If  the  selected  archive  contains    the  backup  of  an   AmigaDOS
  341.   partition, ABackup will load the  catalogue  of  files  backed  up  in  this
  342.   archive and will display the selection screen. This screen is  described  in
  343.   the "The_selection_screen" section. Restore options are as follows:
  344.  
  345.   Restore dir. tree
  346.       Indicates if selected  files  will  be  all  restored  in  the  same
  347.       directory (NO) or if the tree structure will be restored too  (YES).
  348.  
  349.   Restore date
  350.       Indicates if ABackup will set the date of restored file to the  date
  351.       they had at backup time.
  352.  
  353.   Restore links
  354.       Restore selected links. Meaningful only under 2.0 system release.
  355.  
  356.   Restoration report
  357.       The left gadget tells if ABackup has to create a restoration report.
  358.       This one can be printed or written to a file. The right gadget tells
  359.       if this report will be a long one (detailled) or a short  one  (only
  360.       errors).
  361.  
  362.   Restore empty dirs
  363.       Indicates if ABackup has to create empty backed up directories.
  364.  
  365.   Replace files
  366.       Indicates what ABackup has to do if a file it has to restore already
  367.       exists. Choices are: "No" (file is not  replaced),  "Yes"  (file  is
  368.       replaced), "Ask for" (ABackup will ask to confirm for every existing
  369.       file), "Older" (ABackup replaces the file only if this one is  older
  370.       than the backed up file).
  371.  
  372.   Restore from
  373.       This option is available only when restoring from floppy    disks.    It
  374.       allows to use several disk drives: specify the names of  the  drives
  375.       separated by a coma. For example, if you specify "df0:,df1:" ABackup
  376.       will start with disk in df0:, then continue with the disk  in  df1:,
  377.       go back to df0:, etc...  The  program  will  automatically  (without
  378.       requester) toggle from one drive to the next, if the disk in the new
  379.       drive has been changed and if this disk is the one which is expected
  380.       by ABackup.
  381.  
  382.   Restore to
  383.       Usually, files are restored in the directory where they were at  the
  384.       time of the backup, but you can specify another  directory  by  this
  385.       gadget.
  386.  
  387.       For starting a restoration, you have to select the "Start"  item  in
  388.   "Restore" menu or the "START" gadget. If you asked for restoration report to
  389.   be written to a file, a requester will be brought up so that you can specify
  390.   a name for this  file.  If  you  click  over    the  "Abort"  button  in  this
  391.   requester, no report will be generated.
  392.       At this time, a new screen is brought up with different infos on the
  393.   restore progression. In the bottom area, the names of  restored  files  pass
  394.   by, followed by an info on the current opération (reading, etc....).  If  an
  395.   error occurs (and if this is possible), ABackup will display  a  message  to
  396.   ask if you want to continue in spite of that. Obviously,  ABackup  will  not
  397.   restore the file that maked problem. If  some  links    are  to  be  restored,
  398.   ABackup will    restore  them  after  all  other  files  and  directories  are
  399.   restored.
  400.       At the top and on the right of this screen there  are  two  gadgets.
  401.   The "* ABORT *" gadget allows to abort a  restoration.  After  it  asked  to
  402.   confirm, ABackup returns to the selection  screen.  The  "* PAUSE *"  gadget
  403.   allows to pause restoration for a while. Note that it  can  happens  ABackup
  404.   doesn't react immediatly when you click over one of these  gadgets  but,  in
  405.   all cases, your request will be registered before the next read operation in
  406.   the archive.
  407.       Once a restoration ended  (a  message  will  inform  you  of  that),
  408.   ABackup  returns  to    its  main  screen.  After  restoring  a   non-AmigaDOS
  409.   partition, you will have to reboot your Amiga in order  to  let  the    system
  410.   take the new partition contents in account.
  411.  
  412. Rebuild_catalogue
  413.  
  414.       This function is not very useful unless an  archive  file  has  been
  415.   damaged, or you have loose the last disk of a backup set.  It  will  rebuild
  416.   the archive catalogue, which is required to restore.    You  should  be  aware
  417.   that this function can't handle all  errors,  and  may  not  be  usuable  by
  418.   unexperienced users.
  419.  
  420.       If the archive is a file, you should first make a copy of this file,
  421.   in order to avoid to destroy it if the operation fails. You will  also  have
  422.   to check that the first header is at a  sector  boundary,  that  is,    at  an
  423.   address multiple of 512 (you can use the "TYPE  archive  HEX"  command,  the
  424.   first and the third long word of a header  are  always  set  to  the    "ABCK"
  425.   value). If the archive is on disks, you must give  the  disks  in  the  same
  426.   order they were written to. This function works even if disks are missing.
  427.  
  428.       The archive selection screen appears (see "Restore"  section).  When
  429.   you have selected the archive, ABackup loads its contents, file after  file:
  430.   a new screen appears with some informations about the processing.  Once  the
  431.   contents is loaded, the new catalogue will be created. If the archive is  on
  432.   disks, ABackup will ask you for a new disk to write the catalogue. Use  this
  433.   disk a the last disk of the backup set, when restoring.
  434.  
  435. The_selection_screen
  436.  
  437.       This screen consists of a gadgets set and a bottom  area  where  are
  438.   displayed files and subdirectories of the current directory. At  the    start,
  439.   no file and no directory are selected. Files are displayed in black on  grey
  440.   background, and directories in white on grey. Directories with at least  one
  441.   descendant selected are displayed on a black background. You can scroll  the
  442.   list display by means of the vertical scroll bar on the right. The  name  of
  443.   the current directory is displayed in the area named "Directory". The number
  444.   and size of the selected files are displayed in the area named  "Selection".
  445.  
  446.       For selecting a file in a list, click on the name of this  file:  it
  447.   is displayed in black on a blue  background  and  the  "Selection"  area  is
  448.   updated. If you click on a selected file, this one will be  unselected.  For
  449.   selecting or unselecting a set of files, click on the first  file  and  keep
  450.   down the left button while moving your mouse. Last, to  view    a  file,  just
  451.   double-click on its name (see "Viewing" section).
  452.       When you click on a directory name, two actions can occur.  If  this
  453.   directory is empty, it will be selected or unselected as a file.  Otherwise,
  454.   the list display will be modified in order to make visible the  contents  of
  455.   this directory. The "Directory" area will be updated.  To  go  back  to  the
  456.   previous directory, you can either click on the "Parent" gadget (at the  top
  457.   of the scroll bar), either click on the gadget between the  left  border  of
  458.   the screen and the left border of the display area. If you went very down in
  459.   the tree structure, you can go back straight at  the    initial  directory  by
  460.   clicking on the "Root" gadget (at the top of the scroll bar).
  461.       Last, if you hold the SHIFT key while you  click  upon  a  directory
  462.   name, the whole directory contents will be selected or deselected.
  463.  
  464.       At the top of the screen, there are two rows of  identical  gadgets.
  465.   These ones allow to select (first row) or to  unselect  (second  row)  files
  466.   and/or subdirectories in a global way according to various criterions:
  467.  
  468.   All
  469.       Selects or unselects all files and subdirectories from  the  current
  470.       directory.
  471.  
  472.   By name
  473.       Selects or unselects files and subdirectories according to a name or
  474.       a pattern. A pattern is a name with  one    of  the  special  AmigaDOS
  475.       characters: '#' or '?' under 1.3 system release, '#', '?', '|', '~',
  476.       '%', parenthesis, or brackets under 2.0  system  release.  For  more
  477.       informations, refer to your AmigaDOS User's manual.
  478.       A window is displayed with a string gadget. Type in it a name  or  a
  479.       pattern and validate your choice by pressing  <RETURN>.  Now,  click
  480.       either on the "==" gadget, if you want files or subdirectories whose
  481.       name matches the name or the pattern you typed, either on  the  "!="
  482.       gadget, if you want files or subdirectories whose name doesn't match
  483.       the name or pattern you typed. You  can  cancel  this  operation    by
  484.       clicking on the window close gadget.
  485.  
  486.   By date
  487.       Selects or unselects files and subdirectories according to the  date
  488.       of the last change. A window is brought up  with    a  string  gadget.
  489.       Type in a date and/or time respecting the following syntax: DD-MM-YY
  490.       or DD-MMM-YY for the date (for example, "01-03-92" or  "01-Mar-92"),
  491.       and HH:MM:SS for time. Validate your choice by pressing the <RETURN>
  492.       key, then click over the "<=" gadget or the ">="  gagdet,  according
  493.       as you want to get earlier files and subdirectories or later ones in
  494.       relation to the typed date.
  495.       If you typed only time, the date will be the day date. If you  typed
  496.       only a date, time will be "23:59:59", when you click over  "<=",  or
  497.       "00:00:00", when you click over ">=". You can cancel this  operation
  498.       by clicking on the window close gadget.
  499.  
  500.   By bits
  501.       Selects or unselects files and  subdirectories  according  to  their
  502.       protection bit. A window is brought up with  a  string  gadget.  For
  503.       testing one or several bits (see the  AmigaDOS  command  "Protect"),
  504.       type them in this gadget and validate your choice  by  pressing  the
  505.       <RETURN> key. Click now over the "= 1" or "= 0" gadget according  as
  506.       you want files and subdirectories with their bits set or unset.  You
  507.       can cancel this operation by clicking on the window close gadget.
  508.  
  509.       The "Reverse" gadget allows to  invert  a  selection:  all  selected
  510.   files become unselected  and    all  unselected  files    become    selected.  The
  511.   "Recursive" gadget controls the action of the "Reverse" gadget, just  as  it
  512.   controls the "All", "By name", "By date" and "By bits" gadgets: it shows  if
  513.   selecting or unselecting will or will not concern  files  that  are  in  the
  514.   subdirectories of the current directory.
  515.  
  516.       The selection screen has three menus too. The "Size" menu allows  to
  517.   change unit ABackup is using to display the size of selected files. You  can
  518.   choose beetween Bytes (the default unit), Kilobytes and  Megabytes.  If  you
  519.   select the "Automatic" item, ABackup  will  automatically  change  of  unit,
  520.   depending  of  the  size  of    selected  files.  Later,  we'll  describe  the
  521.   "Selection" menu. Last, the first  menu  is  either  "Backup"  or  "Restore"
  522.   (depending of which operation you've choosen) and has the following options:
  523.  
  524.   Start
  525.       Allows to start backup or restore. If you selected no  file  and    no
  526.       subdirectory, an error message will be displayed.
  527.  
  528.   Options
  529.       Allows to change the backup or restore options.
  530.  
  531.   Estimations
  532.       Gives an estimation of backup  time  and    of  the  number  of  disks
  533.       needed. The result depends of the size of  the  selected    files,    of
  534.       backup options, and of the processor inside your Amiga. It  may  not
  535.       be accurate if other tasks are running during  the  backup.  ABackup
  536.       always suppose that you backup a hard disk to floppies.
  537.  
  538.   About...
  539.       Displays some informations  on  this  program.  To  continue,  click
  540.       within the window, over the window close gadget or press any key.
  541.  
  542.   Abort
  543.       Allows to abort whole operation. After it asked to confirm,  ABackup
  544.       returns to the main screen.
  545.  
  546. Error_recovering
  547.  
  548.       When an error occurs while writing on  a  disk,  you    will  see  the
  549.   following message "Write error on DFx:, should I try to recover ?".  If  you
  550.   answer "NO", the backup will be aborted.
  551.       If you answer "YES", ABackup will copy all data already  written  on
  552.   the bad disk to a new disk, so backup will be able  to  continue.  The  copy
  553.   will be processed using a single disk drive. You will have to provide a  new
  554.   disk of the same type than the bad one: you can't use (for example)  a  High
  555.   Density disk (1.76 Mb) to replace a normal density disk (880 Kb).
  556.  
  557.                     CAUTION:
  558.  
  559.       Follow the program intructions : don't  remove  the  faultly
  560.       disk until ABackup ask you to insert a new disk. If  ABackup
  561.       ask you to give again the bad disk it means that, due  to  a
  562.       lack of memory, it was not able to  copy  the  disk  in  one
  563.       pass. You will have to give again the bad disk, then the new
  564.       disk. 
  565.  
  566. Viewing
  567.  
  568.       From    the  selection    screen,  you  can  view  any  file   just   by
  569.   double-clicking on its name. A window appears, with several gadgets.
  570.       The "Execute" gadget shows the name of the viewer  to  use  for  the
  571.   selected file. The file's name and type (from which the name of  the  viewer
  572.   is set) are displayed above You can, of  course,  modify  the  name  of  the
  573.   program to use. The two lower gadgets  allow    you  to  start    viewing  ("OK"
  574.   gadget), or to abort operation ("CANCEL" gadget).
  575.       If you ask to view a link, ABackup will display the name of the file
  576.   or directory the link points to.
  577.       If you ask to view a non-AmigaDOS partition,    ABackup  will  display
  578.   the partition's caracteristics.
  579.  
  580. Compression
  581.  
  582.       ABackup is able to compress files to    backup,  in  order  to    reduce
  583.   archive size. By default, the algorithm is the same as  for  the  "compress"
  584.   UNIX command: you can hope for a space-saving  from  30%  to    50%,  but  the
  585.   backup is seriously slowed down with a "normal" 68000 based Amiga.
  586.       Note that ABackup will not try to  compress  files  with  a  ".lha",
  587.   ".lzh", ".zoo", ".arc", ".pp" or ".z" file name extension, as  well  as  any
  588.   file less than 512 bytes long. You can specify  other  extensions  to  don't
  589.   compress, with the NOCOMP argument (see "Getting_started" section).  ABackup
  590.   also look at the first bytes of the files, in order to detect files  already
  591.   compressed by XPK or PowerPacker.
  592.  
  593.       You can also use external compression  and  decompression  programs,
  594.   which may be faster and/or better. All you have to do is the modify  ABackup
  595.   configuration (see "Configuration" section) and enter the command to execute
  596.   for both compression and decompression. Argument specification must use  the
  597.   following syntax:
  598.  
  599.       %0      full name of source file
  600.       %1      path name of source file
  601.       %2      base name of source file
  602.       %3      full name of destination file
  603.       %4      path name of destination file
  604.       %5      base name of destination file
  605.  
  606.   The old "%s" and "%d" specifications are still accepted, and match  the  new
  607.   "%0" and "%3" specifications. Here are two examples:
  608.  
  609.   1) To use the "PowerPacker" (copyright par Nico François) related commands
  610.  
  611.   Crunch %s %d NOLED NOPER NOSUFFIX EFFICIENCY 1
  612.   Decrunch %s %d QUIET
  613.  
  614.   2) To use the archiving program "Lha" (copyright par Stefan Boberg)
  615.  
  616.   Lha a %d %s
  617.   Lha e %s %5 %4
  618.  
  619.   It is advised to make the external programs residents  if  possible,    or  to
  620.   copy them in RAM:, in order to reduce the time required by AmigaDOS to  load
  621.   them in memory. You may also have  to  specify  the  full  pathname  of  the
  622.   commands.
  623.  
  624.       You won't be able to select  external  compression  as  long  as  no
  625.   command name    has  been  given.  When  backing  up  and  restoring,  ABackup
  626.   automatically runs the specified commands, and redirect their output to  the
  627.   "T:ABackup.log" file. You can look at this file if an error  occurs.  Please
  628.   note that external compression can't be used when  backing  up  non-AmigaDOS
  629.   partitions.
  630.  
  631.       This version of ABackup can also use the XPK library (on  Fish  disk
  632.   754). This library will be automatically recognized  if  installed  in  your
  633.   "LIBS:" directory. You will then be able to  select  one  of  the  available
  634.   compression method, in the options window.  The  name  of  the  methods  are
  635.   prefixed with a "x" character, like "x BLZW".
  636.  
  637.       Take care that it won't be possible to restore an archive compressed
  638.   with an external program, or    with  XPK  library,  if  you  don't  have  the
  639.   corresponding  decompression    program.  Though,  you    should    avoid  to  use
  640.   external compression if you plan to give the archive to somebody else.
  641.  
  642. The_catalogue
  643.  
  644.       ABackup creates a catalogue of the archived files,  and  use    it  to
  645.   restore. This catalogue is put at the end of the archive. If you  loose  the
  646.   catalogue (archive file damaged or last disk lost), you  can  create  a  new
  647.   catalogue with the "Rebuild_catalogue" function, described above.
  648.  
  649.       This version of ABackup  uses  a  new  catalogue  format,  far  more
  650.   compact than the previous one: this format is two  or  three    times  smaller
  651.   than before. The size of the catalogue is now displayed when ABackup add  it
  652.   the the archive. Of course, this program can load a catalogue created by the
  653.   older versions of ABackup, but the contrary is not true.
  654.       Even with this new format, you may have  memory  problems  with  big
  655.   archives (several thousands of files) because the catalogue will take a  lot
  656.   of memory. If you ever have a "not  enough  memory"  error  when  loading  a
  657.   catalogue (whatever version of ABackup  you  use)  here  is  two  tricks  to
  658.   restore files anyway.
  659.  
  660.       The first solution is to reboot you Amiga, so you'll start  with  an
  661.   unfragmented memory. If you mounted  a  "RAD:"  disk,  remove  it  with  the
  662.   "RemRAD" command before you reboot. If you have  some  background  utilities
  663.   you don't need while restoring, kill them to free more memory. Then, use the
  664.   TMPDIR argument to assign the temporary directory to a hard  disk  partition
  665.   with at least 1 Mb of free space, and try again to restore. If ABackup fails
  666.   again, you will have to use the second method.
  667.       The second solution is  to  create  new  catalogues,    that  will  be
  668.   smaller. If the archive has been created with an  old  version  of  ABackup,
  669.   first try to make only one catalogue: as the new  format  is    more  compact,
  670.   maybe this will be enough. Else, you will have to make  several  catalogues:
  671.   divide your archive in several parts, and create a new  catalogue  for  each
  672.   part.
  673.  
  674. The_Selection_menu
  675.  
  676.       ABackup has the capability of recording a file selection so that you
  677.   can recall it later: this can be useful  if  you  use  frequently  the  same
  678.   selections. These ones are kept as text files containing a set of  commands:
  679.   these files are in the "ABCK:" directory.
  680.       In order to record a selection, choose  the  "Record"  item  in  the
  681.   "Selection" menu; then, do your selection as  you  do  usually.  Note  that,
  682.   during this recording, the "Backup" or the "Restore" menu disappear (for the
  683.   time being). Once you have ended, select the item "Save" in the  "Selection"
  684.   menu to save your selection. If you want to abort a  recording,  choose  the
  685.   item "Abort" in the "Selection" menu.
  686.       To recall a selection, choose the "Load"  item  in  the  "Selection"
  687.   menu. A file requester  will    be  displayed  allowing  you  to  specify  the
  688.   selection file you want use. If you click on the "OK" gadget  in  this  file
  689.   requester, that file will be    loaded    and  selection    it  contains  will  be
  690.   executed.
  691.  
  692.       This is description of the selection language used by ABackup.  This
  693.   allows to create or modify a selection file as you like, by  means  of  your
  694.   usual text editor.
  695.  
  696.       CD :                  go back to root directory
  697.       CD /                  go back to parent directory
  698.       CD "dir"                        go down in given directory
  699.       INVERT                  reverse selection
  700.       RECURS {YES|NO}              set recursivity flag
  701.       INCLUDE ALL              include all files
  702.       INCLUDE "name"                  include given file/dir
  703.       INCLUDE NAME "name" {==|!=}     select by name
  704.       INCLUDE DATE "date" {<=|>=}     select by date
  705.       INCLUDE BITS "bits" {=0|=1}     select by protection bits
  706.       EXCLUDE ALL              exclude all files
  707.       EXCLUDE "name"                  exclude given file/dir
  708.       EXCLUDE NAME "name" {==|!=}     exclude by name
  709.       EXCLUDE DATE "date" {<=|>=}     exclude by date
  710.       EXCLUDE BITS "bits" {=0|=1}     exclude by protection bits
  711.  
  712.   Here is an example of selection file:
  713.  
  714.       RECURS YES
  715.       ; go back to root
  716.       CD :
  717.       ; clear any selection
  718.       EXCLUDE ALL
  719.       ; include all files with archive bit cleared
  720.       INCLUDE BITS "a" =0
  721.       ; exclude all ".o" files
  722.       EXCLUDE NAME "#?.o" ==
  723.  
  724.       Note that empty lines and lines starting  by    a  ";"  character  are
  725.   ignored.  Also  note    that  ABackup  stores  automatically  the  recursivity
  726.   indicator state at the beginning of your selection record:  if  you  take  a
  727.   look at the created files you'll see they all beging by a "RECURS"  command.
  728.   If you want to be sure to clear a previous selection,  it's  recommended  to
  729.   start all your selections by clicking on  the  "ROOT"  gadget  and  then  on
  730.   "EXCLUDE ALL".
  731.  
  732. Usage_without_interface
  733.  
  734.       ABackup can be used from CLI, without it's graphic  interface.  This
  735.   may be useful for doing automatical backup, with programs like "cron".  Four
  736.   operations are allowed from this level: backup, restore, rebuild  catalogue,
  737.   archive listing.
  738.  
  739.       Backup is started with a command like:
  740.  
  741.       ABackup BACKUP FROM dir TO arc SELECT  {ALL|ARC|NDOS|file}  [OPTIONS
  742.       {C|V|A|L|S|K}] [NOCOMP ext,ext,...] [VERBOSE] [REPORT file] [BUFSIZE
  743.       size] [NOTASK] [TMPDIR dir]
  744.  
  745.   where "dir" is the directory to backup and "arc" the name of the archive  to
  746.   create. The "SELECT" argument allows to select files to backup: it  must  be
  747.   followed by the name of a selection file (for example "ABCK:FullBackup"), by
  748.   the "ALL" keyword which allow to select all  files,  by  the  "ARC"  keyword
  749.   which allow to select all files with archive bit cleared, or by  the    "NDOS"
  750.   keyword which specify backup of a non-AmigaDOS partition.
  751.       The "OPTIONS" optional  argument  allow  to  change  backup  options
  752.   (CAUTION: by default, ALL options are reset): "C" for compression,  "V"  for
  753.   verifying, "A" to set archive bit, "L" to backup  links,  "S"  for  a  short
  754.   report, "K" to encrypt data. You can specify several  options  (for  example
  755.   "OPTIONS CV").
  756.       The "REPORT" optional  argument  allow  to  have  a  backup  report.
  757.   Specify "PRT:" as a file name in order to  have  this  report  printed.  The
  758.   "VERBOSE" optional argument allow to have more messages during  backup.  The
  759.   other arguments are described at the "Getting_started" section.
  760.  
  761.       Restore is started with a command like:
  762.  
  763.       ABackup RESTORE FROM arc [TO dir]  SELECT  {ALL|NDOS|file}  [OPTIONS
  764.       {F|D|E|L|S}]    [REPLACE  {YES|ASK|OLDER}]  [VERBOSE]  [REPORT     file]
  765.       [BUFSIZE size] [NOTASK] [TMPDIR dir]
  766.  
  767.   where "arc" is the name of the archive.  The  "SELECT"  argument  allows  to
  768.   select files to restore: it must be followed by the name of a selection file
  769.   (for example "ABCK:SourcesFiles"), by  the  "ALL"  keyword  which  allow  to
  770.   select all files, or    by  the  "NDOS"  keyword  which  allow  to  restore  a
  771.   non-AmigaDOS partition.
  772.       The "TO dir"  optional  argument  allow  to  restore  files  in  the
  773.   specified directory, rather than the directory they were at backup time.
  774.       The "OPTIONS" optional argument  allow  to  change  restore  options
  775.   (CAUTION: by default, ALL options are reset): "F" to restore  all  files  in
  776.   the same directory, "D" to restore date, "E" to restore  empty  directories,
  777.   "L" to restore links, and "S" for a short report. You  can  specify  several
  778.   options (for example "OPTIONS FE").
  779.       The "REPLACE" optional argument allow to specify what ABackup has to
  780.   do if a file to restore already exists. It must be  followed    by  "YES"  (or
  781.   "Y", the file is replaced),  by  "ASK"  (or  "A",  you  will  be  asked  for
  782.   confirmation), or by "OLDER" (or "O", the file  is  replaced  only  if  it's
  783.   older than the one in the archive). By default, files are not replaced.
  784.       The "REPORT" optional argument allow to have a  restoration  report.
  785.   Specify "PRT:" as a file name in order to  have  this  report  printed.  The
  786.   "VERBOSE" optional argument allow to have more messages during restore.  The
  787.   other arguments are described at the "Getting_started" section.
  788.  
  789.       Rebuilding catalogue is started with a command like:
  790.  
  791.       ABackup REBUILD FROM arc [VERBOSE] [BUFSIZE size]  [NOTASK]  [TMPDIR
  792.       dir]
  793.  
  794.   where "arc" is the name of the  archive.  The  "VERBOSE"  optional  argument
  795.   allow to have more messages  during  processing.  The  other    arguments  are
  796.   described at the "Getting_started" section.
  797.  
  798.       Archive listing is started with a command like:
  799.  
  800.       ABackup LIST FROM arc [TO file] [NOTASK] [TMPDIR dir]
  801.  
  802.   where "arc" is the name of the archive.  The  "TO  file"  optional  argument
  803.   allow to write the listing into the specified file, rather than the  console
  804.   window. Specify "PRT:" as a file name in order to have the list printed. The
  805.   other arguments are described at the "Getting_started" section.
  806.  
  807. Program_history
  808.  
  809.       ABackup is written almost fully in C language, and was developped on
  810.   an Amiga 3000 UNIX-1 (10 Mb RAM, internal HD disk drive, two  internal  hard
  811.   disks of 100 Mb and 160Mb, external SyQuest drive of 88 Mb, external    floppy
  812.   disk drive, 1960 monitor and Star LC24-10 printer) connected by a null-modem
  813.   cable to an A500 with 1 Mb RAM.
  814.  
  815.   v1.00, 08-Jun-92, 58036 bytes
  816.  
  817.   v1.10, 20-Jun-92, 59404 bytes
  818.       o Handles High Density floppy disks (1.76 Mb).
  819.       o When run from the Workbench, you can  change  the  size  of  the  read
  820.     buffer with "BUFSIZE=<size in  Kb>"  in  the  "TOOL  TYPES"  field  of
  821.     ABackup icon.
  822.       o Several changes in backup:
  823.     - when there is any problem at initialization time, goes back  to  the
  824.       selection screen
  825.     - when an archive file exists, or there is already a  disk  in    drive,
  826.       asks to confirm before starting writing
  827.     - tests if files to back up are protected against a  read  (opening  a
  828.       file works in any case, but under 2.0 system    release  you  will  be
  829.       kicked out at the first read operation)
  830.     - displays the compression rate for every file (after "OK")
  831.       o Several changes in the interface:
  832.     - added the "Size" menu in the selection screen (Bytes/Kb/Mb)
  833.     - displays backed-up/restored percentage and remaining one
  834.     - the "monitor" window (in blue) is larger when screen is in PAL  mode
  835.       o Time valuation more accurate (uses the "timer.device").
  836.  
  837.   v1.20, 28-Jun-92, 62616 bytes
  838.       o Added the "Selection" menu in the selection screen: you can  record  a
  839.     selection and recall it later.
  840.       o Fixed several bugs:
  841.     - as a result of an error in the computing of remaining place  in  the
  842.       last disk, sometimes it wrote a catalogue overlapping two  different
  843.       floppies
  844.     - when you swapped a disk during a file header writing, it  forgot  to
  845.       set up the disk position at 0 (in the catalogue)
  846.     - during a read, at the end of a disk, it detected one byte earlier it
  847.       had to ask for the next disk.
  848.       o  For  a  by  date  selection,  you  can  give  the  month  name  (e.g.
  849.     "01-Jan-92")
  850.       o When run from the Workbench, it does  not  open  the  small  "console"
  851.     window.
  852.  
  853.   v1.30, 01-Jul-92, 67640 bytes
  854.       o Double-click upon a name starts a "view" operation
  855.       o  Under    2.0  system  release,  uses  "dos.library"  pattern   matching
  856.     functions (more powerful than SAS/C ones)
  857.       o Added "Estimation" option in "Backup" menu
  858.       o Displays error messages rather than error codes
  859.       o Bug fixed in  "draggin  select":  didn't  displayed  directories  when
  860.     scrolling list
  861.       o Restore screen's title when "Abort" is selected on  archive  selection
  862.     menu (Restore)
  863.  
  864.   v1.31, 04-Jul-92, 68316 bytes (Fish #706)
  865.       o Added "Restore date" option
  866.       o Added auditive beep in alert/wait functions
  867.       o No more need for "arp.library" to make drives "BUSY" under 1.3  system
  868.     release
  869.       o Estimations more accurate (don't suppose that last disk is full)
  870.  
  871.   v1.40, 22-Aug-92, 78328 bytes
  872.       o Can use several disk drives for backup
  873.       o Full access from CLI ("batch" mode)
  874.       o Bug fixed: always tried to decompress archive catalogue  (even  if  it
  875.     was not)
  876.       o Bug fixed: when loading archive file catalogue,  scanned  all  archive
  877.     beginning (instead of going straight to the good location)
  878.       o Preparation of non-dos partitions backup (most of  the  required  code
  879.     written)
  880.       o Added visual beep to each auditive beep
  881.  
  882.   v1.50, 09-Sep-92, 81068 bytes
  883.       o Added support for links under 2.0 system release (both hard  and  soft
  884.     links are handled)
  885.       o Added "Backup links" and "Restore links" options
  886.       o Added "Automatic" item to "Size" menu
  887.       o Added "NOCOMP ext,ext,..." argument
  888.       o When requesting a disk for writing, verifies that the disk has    really
  889.     been changed before continuing
  890.       o If an error occurs while writing on a disk, make one retry
  891.       o Error in percentage computation corrected
  892.       o On selection screen, directories with at least one child selected  are
  893.     displayed on a black background
  894.       o No more overflow from "monitor" window if file name is too long
  895.       o Bug fixed in SendPacket() function
  896.       o Bug fixed in time computation (00:29:59 + 1 gave 01:00:00  ...  whoops
  897.     !)
  898.       o Forgotten trace message removed
  899.  
  900.   v1.51, 07-Oct-92, 81048 bytes
  901.       o Any file or directory whose comment begins with  "SKIPME"  is  ignored
  902.     when loading directory tree
  903.       o Bug fixed: no more problems if the size of a file change  between  the
  904.     time we load directory tree and time we save the file
  905.       o Bug fixed: didn't clear destination name between two restore  (so  the
  906.     second was made is the same directory than the first)
  907.       o Update status display when disk is changed
  908.  
  909.   v1.60, 15-Oct-92, 84312 bytes (Fish #759)
  910.       o Added function to rebuild catalogue
  911.       o Selection  screen  modified  (added  "OPTIONS"  and  "START"  gadgets,
  912.     etc...)
  913.       o Estimations for 68000 Amigas corrected (thanks to JYP !)
  914.       o If a file is read protected (under 2.0 system release) ask for retry
  915.       o When restoring, display the name of the file created  instead  of  the
  916.     name in the archive
  917.       o Restore option "At the same level" renamed "Restore dir. tree"
  918.  
  919.   v1.61, 21-Oct-92, 84472 bytes
  920.       o From WB may be set as "DEFAULT TOOL" of an archive file
  921.       o File  type  (for  visualisation):  no  longer  binary  when  an  <ESC>
  922.     character is found
  923.       o Window are now centered on the screen
  924.       o Menus are no longer present during backup or restore
  925.  
  926.   v1.70, 29-Oct-92, 87016 bytes
  927.       o Can use external programs for compression/decompression
  928.       o Added a menu for the startup screen (Config, About, Quit)
  929.       o Screen's title show what is the current operation
  930.       o On selection screen, when restoring, the "Directory" field  shows  the
  931.     destination directory
  932.       o By default, compression is disabled
  933.       o Documentation modified so it can be read with ADoc
  934.  
  935.   v1.80, 11-Nov-92, 88528 bytes
  936.       o Creates a child task for disk write operations (speedup backup between
  937.     10-20%)
  938.       o Sets archive bit only on files/dirs which have not it already set
  939.       o Filenames are truncated to the left instead of the right  ("Directory"
  940.     field, "monitor" window, e.g. ".../foo/bar")
  941.  
  942.   v2.00, 22-Nov-92, 90492 bytes (Fish #780)
  943.       o Can use XPK library
  944.       o Added the error recovering function
  945.  
  946.   v2.01, 06-Dec-92, 90520 bytes
  947.       o When using XPK compression, sometimes forgot  to  delete  a  temporary
  948.     file
  949.       o Disable compression if    preferences  tells  to    use  XPK  and  library
  950.     couldn't be opened
  951.       o Cosmetics changes on file requester
  952.  
  953.   v2.10, 12-Dec-92, 88652 bytes
  954.       o Compiled with SAS/C 6.00
  955.       o New catalogue format, far more compact
  956.       o Show catalogue size when adding it to archive
  957.       o A few optimizations in display functions (gadget borders now draw with
  958.     GfxGList instead of GfxOp)
  959.       o The "Parent" gadget at the left of the file list has now a border
  960.  
  961.   v2.11, 19-Dec-92, 88708 bytes
  962.       o When writing catalogue, display the informations  as  when  writing  a
  963.     file (Crunching, Writing, Ok x%)
  964.       o Updating informations when disk changed: now only disk number and time
  965.     modified
  966.  
  967.   v2.12, 25-Dec-92, 89492 bytes
  968.       o Compiled with SAS/C 6.1
  969.       o Verifies XPK.library version (at least version 2)
  970.       o Added argument TMPDIR to change temporary directory
  971.  
  972.   v2.13, 08-Jan-93, 90208 bytes
  973.       o Child task disabled under system release 3.0,  because    it  makes  the
  974.     system crash.
  975.       o When modifying backup options, compression methods  cycle  in  reverse
  976.     order if SHIFT key is hold down.
  977.       o When backing up to a file, the gauge displays the  filling  percentage
  978.     of the volume.
  979.       o Bug fixed: in "batch" mode, forgotted the target  directory  specified
  980.     for restoration.
  981.  
  982.   v2.20, 16-Jan-93, 90644 bytes
  983.       o Can now restore from several disk drives
  984.       o Bug fixed in backup: saved the target name instead of  the  link  name
  985.     (though didn't found the link at restore time)
  986.       o Bug fixed in backup: the AddCatalog()  function  didn't  returned  the
  987.     correct return code if the catalogue wasn't compressed
  988.       o Bug fixed in restore: didn't restore the correct date for  directories
  989.       o Bug fixed in reports: didn't write the correct date for directories
  990.       o The call of viewer programs is safer
  991.  
  992.   v2.30, 24-Jan-93, 91700 bytes
  993.       o Can now save several partitions in the same archive
  994.       o Bug fixed when writing configuration file: the    viewer    program  names
  995.     were not written at the good position
  996.       o The temporary directory can be modified in the    configuration  window,
  997.     and saved in the configuration file.
  998.       o Added the "SIZE" argument (changes default value of "Size" menu)
  999.       o Communication with child task now performed via messages  (instead  of
  1000.     signals)
  1001.       o Child task stack size is now 4Kb (instead of 2Kb)
  1002.       o Shortening names too long: now tries to remove a full  directory  name
  1003.     until it works, also done when writing reports.
  1004.       o Bug fixed in date computation.
  1005.       o Since v2.20, viewing a    file  didn't  worked  if  the  viewer  program
  1006.     detached itself.
  1007.       o Final requester of non-registered version more irritating
  1008.       o A few optimizations in display functions
  1009.  
  1010.   v2.31, 30-Jan-93, 91888 bytes
  1011.       o If a SHIFT key is hold down while you click upon a directory name, the
  1012.     whole directory contents is selected/deselected
  1013.       o Drag selecting now also include/exclude directories
  1014.       o Bug fixed: sometimes losed archive name before starting restore
  1015.  
  1016.   v2.40, 06-Feb-92, 92364 bytes (Fish #838)
  1017.       o No more crashes with child task under OS 3.0 (KS 39.106, WB 39.29)
  1018.       o Recompiled with SAS/C 6.2
  1019.       o Link restoration more efficient (no need to insert disks twice)
  1020.       o Directory sort faster (QuickSort instead of Shell sort)
  1021.       o Enhanced multi-selection in file requester
  1022.  
  1023.   v2.41, 20-Feb-93, 93124 bytes
  1024.       o Can now use the file requester from asl.library (USEASL argument)
  1025.       o Recognize now XPK and PowerPacker  compressed  data  files  and  don't
  1026.     compress them
  1027.       o Add a comment to archive files saying they are ABackup archive files
  1028.  
  1029.   v2.42, 23-Feb-93, 93264 bytes
  1030.       o Bug fixed: when using external compression, ABackup tried  to  restore
  1031.     protection bits and date on the  temporary  file  (which  was  already
  1032.     deleted) instead of the restored file.
  1033.       o Bug fixed: for Lock() to work on a  soft-link,  you  must  be  in  the
  1034.     directory were is the link, so now temporary changes of directory.
  1035.       o Bug fixed in french version: if an error occured when setting  archive
  1036.     bit, the error message was not good
  1037.       o Bug fixed in english version: didn't display catalogue size at the end
  1038.     of the backup
  1039.  
  1040.   v2.43, 13-Mar-93, 93328 bytes
  1041.       o Bug  fixed:  the  "rebuild  catalogue"  function  didn't  worked  with
  1042.     multi-partitions archives
  1043.       o Better requesters look (add a bow with GfxGList instead of writing  on
  1044.     a black background, etc...)
  1045.       o Bug fixed: directory sorting with QuickSort() wasn't ok
  1046.       o Bug fixed: the viewing function crashed on a 68000 (a "short *" wasn't
  1047.     aligned)
  1048.       o Bug fixed in english  version:    the  "bad  XPK  version"  message  was
  1049.     missing
  1050.       o The LIST function asks disks like REBUILD (so you can start  from  any
  1051.     disk, and some disks may be missing)
  1052.  
  1053.   v3.00, 13-May-93, 97820 bytes
  1054.       o Backup and restore non-AmigaDOS partitions
  1055.       o Child task rewritten from scratch (queue write commands, started  with
  1056.     a priority of +5): this version is 15% faster than v2.43
  1057.       o Memory allocation function modified: if allocation fails,  displays  a
  1058.     retry/cancel request telling how much memory ABackup need
  1059.       o Modified screen opening under OS 2.x and 3.0 (uses default values  for
  1060.     size and position, etc...)
  1061.       o External compression management modified:
  1062.     - arguments specification more powerfull (added %0 to %5)
  1063.     - arguments are put between quotes, so no more problems if  there  are
  1064.       spaces in names
  1065.     - the T:ABackup.log file also show the command called
  1066.       o Added data encryption function
  1067.       o Running from Workbench: if a directory icon is given starts a  backup,
  1068.     if a file icon is given starts a restore
  1069.       o Displays only directory names when  loading  directory    contents  (10%
  1070.     faster on an A500 under 1.3)
  1071.       o You can now choose between a long (old manner) or short (errors  only)
  1072.     report
  1073.       o Since v2.31, the RECURSE gadget wasn't correctly managed
  1074.       o Disk drive is stopped as soon  as  restore  is    finished,  instead  of
  1075.     waiting for the user to reply to the "Restore finished" request
  1076.       o When failed to load a selection file, tries  from  ABCK:  if  no  path
  1077.     given
  1078.       o When saving configuration (external  progs),  also  save  the  current
  1079.     palette (allow to change the colors)
  1080.       o When starting, check TMPDIR: if Lock() fails, use "T:"
  1081.       o Usage from CLI and under 1.3 system release checked (a few minor  bugs
  1082.     fixed)
  1083.       o No more problems if there are spaces in a "dfx:,dfy:" specification
  1084.  
  1085.   v3.10, 16-May-93, 98500 bytes
  1086.       o Added sector checksums, in order to be sure that data in write    buffer
  1087.     has not been modified, and are also used to verify data written on the
  1088.     disk.
  1089.       o If a fatal error occurs during backup or restore, go back to selection
  1090.     screen
  1091.       o Removed an unused field in the DiskUnit structure (du_wbuf, opening  a
  1092.     disk drive now requires 11Kb less)
  1093.       o Show catalogue size in backup report
  1094.       o During backup, the "disk" gauge is updated by the child  task  (so  it
  1095.     gives the real position on floppy)
  1096.       o Bug fixed: the "Encryption" option wasn't reported in backup report
  1097.  
  1098.   v3.11, 23-May-93, 98512 bytes
  1099.       o When searching a non-AmigaDOS partition, compares only    the  beginning
  1100.     of the DosEnvec structure (instead of comparing the whole structure)
  1101.       o Two MungWall hits removed
  1102.  
  1103.   v3.12, 03-Jun-93, 99596 bytes
  1104.       o Modified "Restore from" gadget management (value saved in config file,
  1105.     a few bugs fixed, etc...)
  1106.       o When using ABackup from CLI, one part of program initialisation wasn't
  1107.     made so the child task wasn't created and a few checks were missings
  1108.       o All string gadgets for file names have now a gadget to    bring  a  file
  1109.     requester
  1110.       o All string gadgets have now an "Undo Buffer"
  1111.       o Multi-partition archives: the name of the partitions is now  shown  in
  1112.     the report files
  1113.       o A few modifications in source organisation
  1114.  
  1115.   v4.00, 10-Jul-93, 106456 bytes
  1116.       o Compiled with SAS/C 6.3
  1117.       o Adapt itself to default screen size and text font (no size checking !)
  1118.       o Added "FONT" argument (ignored if proportionnal, no size checking !)
  1119.       o Bug fixed: v3.00 to 3.12 had a wrong  read  buffer  size,  so  if  you
  1120.     restored an archived created by v2.43 (or previous) files larger  than
  1121.     32Kb were corrupted. This version read correctly archives  created  by
  1122.     v2.43, but for an archive created by v3.00 to  3.12,  you'll  have  to
  1123.     specify the "NOPATCH" argument. You should also rebuild the catalogue.
  1124.     o Error recovering function enhanced:
  1125.     Didn't worked since v3.10 (as disk was changed, buffer checksums  were
  1126.     lost so you got an alert when ABackup restart writing on the new disk)
  1127.     Since v3.00, wasn't able to recover an error when writing at  the  end
  1128.     of a disk (after a ICMD_SYNC command)
  1129.       o Bug fixed: if a directory to restore already existed, ABackup reported
  1130.     an error because CreateDir() failed (now continue silently)
  1131.       o Extension to don't compress may now  be  modified  in  backup  options
  1132.     window (and saved in config file)
  1133.       o Doesn't stop backup anymory if an error occurs after having written  a
  1134.     file header (the file may be partially  written,  but  this  avoid  to
  1135.     abort backup)
  1136.       o If an error occurs when restoring a file, destroy partial target.
  1137.       o Check STOP/PAUSE gadgets during XPK packing/unpacking
  1138.       o Gadget "Ok" renamed "Use", inverted "Save" and  "Use"  gadgets  to  be
  1139.     compliant   to Style Guide
  1140.       o On selection screen, display directories before files (both will still
  1141.     be mixed when displaying the content of an old archive)
  1142.       o The Shareware requester is now displayed  at  the  beginning  of  each
  1143.     backup/restore/ rebuild operation, without closing gadget, and with  a
  1144.     10s timeout
  1145.       o TMPDIR checking now made in OpenAll()
  1146.       o Palette is loaded from config file only if the two  first  colors  are
  1147.     differents
  1148.       o A few modifications/optimizations in source code
  1149.  
  1150.   v4.01, 01-Aug-93, 106444 bytes
  1151.       o Restoring date now works under KS 1.3
  1152.       o In restoration, if an error occured when reading a  header,  displayed
  1153.     "not restored" but didn't displayed the file name
  1154.  
  1155.   v4.02, 28-Aug-93, 106472 bytes
  1156.       o Bug fixed: viewing didn't worked when restoring since v4.00
  1157.       o Buffers for trackdisk access are not allocated in CHIP memory  anymore
  1158.     under 2.0 system release or greater
  1159.  
  1160.   v4.03, 12-Sep-93, 106704 bytes
  1161.       o  Uses  new  version  of  OuvreEcran(),  so  doesn't  anymore  open  an
  1162.     interlaced screen when default mode is "Productivity"
  1163.       o Bug fixed: one working    area  wasn't  big  enough,  so  caused  memory
  1164.     corruption problems
  1165.       o Uses new version of GetDefaultTextFont(), so search  default  font  in
  1166.     GfxBase instead of preference files.
  1167.       o The internal file requester displays directories before files
  1168.  
  1169.   v4.04, 30-Dec-93, 106004 bytes
  1170.       o Compiled with SAS/C 6.50
  1171.       o Shows my new address in main menu
  1172.  
  1173.   v4.05, 12-Feb-94, 106340 bytes
  1174.       o Compiled with SAS/C 6.51
  1175.  
  1176.   v4.06, 22-Feb-94, 106592 bytes
  1177.       o Enhanced internal file requester
  1178.  
  1179.  
  1180.  
  1181.